<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu155.htm">Previous Page</A> &#124; <A HREF="progu157.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXGAEY" HREF="progu097.htm#PToC_250">DXGetArrayEntry,
DXGetArrayEntries</A></H3>
<A NAME="IDX1691"></A>
<A NAME="IDX1692"></A>
<A NAME="IDX1693"></A>
<A NAME="IDX1694"></A>
<P><STRONG>Function</STRONG>
<P>
Return a specified item or items from an Array.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Pointer DXGetArrayEntry(ArrayHandle handle, int offset, Pointer scratch)<BR>
<P><BR>
void DXGetArrayEntries(ArrayHandle handle, int count, int *offsets,<BR>
                       Pointer *entries, Pointer scratch)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
Given an <TT><STRONG>offset</STRONG></TT> or list of
<TT><STRONG>*offsets</STRONG></TT> into an Array, the routine returns a
pointer or pointers to the memory location(s) containing the
Array elements specified.
(The Array is specified by the Array handle <TT><STRONG>handle</STRONG></TT>,
which must first be created by
<TT><STRONG>DXCreateArrayHandle</STRONG></TT>).
<P>
For <TT><STRONG>DXGetArrayEntry</STRONG></TT>:
The region of memory pointed to by <TT><STRONG>scratch</STRONG></TT> must be
large enough to hold a specified element.
<P>
For <TT><STRONG>DXGetArrayEntries</STRONG></TT>:
The routine returns a list of pointers in <TT><STRONG>entries</STRONG></TT>,
which must be large enough to hold <TT><STRONG>count</STRONG></TT>
pointers.
The parameter <TT><STRONG>scratch</STRONG></TT> must be large enough to hold
<TT><STRONG>count</STRONG></TT> items of the Array.
<P><STRONG>Return Value</STRONG>
<P>
Return a pointer or pointers to the specified entry or entries if the
"offset" value(s) are valid for the Array.
If not, the results are undefined.

Note that you should use the return value of this function,
<U>not</U> <TT><STRONG>scratch</STRONG></TT>.

<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu124.htm#HDRDXCAH">DXCreateArrayHandle</A>,
<A HREF="progu149.htm#HDRDXFAH">DXFreeArrayHandle</A>,
<A HREF="#HDRDXGAEY">DXGetArrayEntry, DXGetArrayEntries</A>,
<A HREF="progu226.htm#HDRDXIA">DXIterateArray</A>
</STRONG></TT>
<P>
<A HREF="progu046.htm#HDRARHAND">"Array Handling"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu155.htm">Previous Page</A> &#124; <A HREF="progu157.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
